Pular para o conteúdo principal

Obter uma chave de API

As chaves de API sao gerenciadas na sua conta Minotaur. Os endpoints desta secao exigem token de sessao (Bearer <session_token>).

Gerar uma chave​

POST /api/api-key/generate
Authorization: Bearer <session_token>
Content-Type: application/json
{
  "name": "Minha Integracao",
  "expiration": 30
}

Valores aceitos para expiration: 7, 30, 90, 365.

Listar chaves​

GET /api/api-key
Authorization: Bearer <session_token>

Retorna os registros de chaves, nunca o valor bruto da chave.

Atualizar ou rotacionar uma chave​

PATCH /api/api-key/update/:id
Authorization: Bearer <session_token>
Content-Type: application/json

Pode atualizar name e/ou expiration, e emite uma nova chave. A chave anterior para de funcionar imediatamente.

Revogar uma chave​

PATCH /api/api-key/revoke/:id
Authorization: Bearer <session_token>

A revogacao e permanente e nao pode ser desfeita.

Notas importantes​

  • O valor da chave aparece apenas uma vez ao gerar/rotacionar.
  • Salve as chaves em um gerenciador de segredos.
  • Para mudar permissoes, rotacione a chave.